Microsoft Cognitive Language Service - Analyze Conversations Authoring (preview:2024-11-15)

2024/12/09 • 48 new methods

AnalyzeConversationAuthoring_ListProjects (new)
Description Lists the existing projects.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects
{
api-version: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
createdDateTime: string ,
lastModifiedDateTime: string ,
lastTrainedDateTime: string ,
lastDeployedDateTime: string ,
projectKind: enum ,
settings:
{
confidenceThreshold: number ,
}
,
storageInputContainerName: string ,
projectName: string ,
multilingual: boolean ,
description: string ,
language: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetProject (new)
Description Gets the details of a project.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}
{
api-version: string ,
projectName: string ,
}

⚐ Response (200)

{
createdDateTime: string ,
lastModifiedDateTime: string ,
lastTrainedDateTime: string ,
lastDeployedDateTime: string ,
projectKind: enum ,
settings:
{
confidenceThreshold: number ,
}
,
storageInputContainerName: string ,
projectName: string ,
multilingual: boolean ,
description: string ,
language: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_CreateProject (new)
Description Creates a new project or updates an existing one.
Reference Link ¶

⚼ Request

PATCH:  /authoring/analyze-conversations/projects/{projectName}
{
api-version: string ,
projectName: string ,
body:
{
projectKind: enum ,
settings:
{
confidenceThreshold: number ,
}
,
storageInputContainerName: string ,
projectName: string ,
multilingual: boolean ,
description: string ,
language: string ,
}
,
}

⚐ Response (200)

{
createdDateTime: string ,
lastModifiedDateTime: string ,
lastTrainedDateTime: string ,
lastDeployedDateTime: string ,
projectKind: enum ,
settings:
{
confidenceThreshold: number ,
}
,
storageInputContainerName: string ,
projectName: string ,
multilingual: boolean ,
description: string ,
language: string ,
}

⚐ Response (201)

{
createdDateTime: string ,
lastModifiedDateTime: string ,
lastTrainedDateTime: string ,
lastDeployedDateTime: string ,
projectKind: enum ,
settings:
{
confidenceThreshold: number ,
}
,
storageInputContainerName: string ,
projectName: string ,
multilingual: boolean ,
description: string ,
language: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_DeleteProject (new)
Description Deletes a project.
Reference Link ¶

⚼ Request

DELETE:  /authoring/analyze-conversations/projects/{projectName}
{
api-version: string ,
projectName: string ,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_CopyProjectAuthorization (new)
Description Generates a copy project operation authorization to the current target Azure resource.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/:authorize-copy
{
api-version: string ,
projectName: string ,
body:
{
projectKind: enum ,
storageInputContainerName: string ,
allowOverwrite: boolean ,
}
,
}

⚐ Response (200)

{
projectKind: enum ,
targetProjectName: string ,
accessToken: string ,
expiresAt: string ,
targetResourceId: string ,
targetResourceRegion: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_CopyProject (new)
Description Copies an existing project to another Azure resource.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/:copy
{
api-version: string ,
projectName: string ,
body:
{
projectKind: enum ,
targetProjectName: string ,
accessToken: string ,
expiresAt: string ,
targetResourceId: string ,
targetResourceRegion: string ,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_Export (new)
Description Triggers a job to export a project's data.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/:export
{
api-version: string ,
projectName: string ,
format: string ,
stringIndexType: string ,
assetKind: string ,
trainedModelLabel: string ,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_Import (new)
Description Triggers a job to import a project. If a project with the same name already exists, the data of that project is replaced.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/:import
{
api-version: string ,
projectName: string ,
format: string ,
body:
{
projectFileVersion: string ,
stringIndexType: enum ,
metadata:
{
projectKind: enum ,
settings:
{
confidenceThreshold: number ,
}
,
storageInputContainerName: string ,
projectName: string ,
multilingual: boolean ,
description: string ,
language: string ,
}
,
assets:
{
projectKind: enum ,
}
,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_Train (new)
Description Triggers a training job for a project.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/:train
{
api-version: string ,
projectName: string ,
body:
{
modelLabel: string ,
trainingConfigVersion: string ,
trainingMode: enum ,
evaluationOptions:
{
kind: enum ,
trainingSplitPercentage: integer ,
testingSplitPercentage: integer ,
}
,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetCopyProjectStatus (new)
Description Gets the status of an existing copy project job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/copy/jobs/{jobId}
{
api-version: string ,
projectName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_ListDeployments (new)
Description Lists the deployments belonging to a project.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/deployments
{
api-version: string ,
projectName: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
deploymentName: string ,
modelId: string ,
lastTrainedDateTime: string ,
lastDeployedDateTime: string ,
deploymentExpirationDate: string ,
modelTrainingConfigVersion: string ,
assignedResources:
[
{
resourceId: string ,
region: string ,
}
,
]
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetDeployment (new)
Description Gets the details of a deployment.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}
{
api-version: string ,
projectName: string ,
deploymentName: string ,
}

⚐ Response (200)

{
deploymentName: string ,
modelId: string ,
lastTrainedDateTime: string ,
lastDeployedDateTime: string ,
deploymentExpirationDate: string ,
modelTrainingConfigVersion: string ,
assignedResources:
[
{
resourceId: string ,
region: string ,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_DeployProject (new)
Description Creates a new deployment or replaces an existing one.
Reference Link ¶

⚼ Request

PUT:  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}
{
api-version: string ,
projectName: string ,
deploymentName: string ,
body:
{
trainedModelLabel: string ,
assignedResourceIds:
[
string ,
]
,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_DeleteDeployment (new)
Description Deletes a project deployment.
Reference Link ¶

⚼ Request

DELETE:  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}
{
api-version: string ,
projectName: string ,
deploymentName: string ,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_DeleteDeploymentFromResources (new)
Description Deletes a project deployment from the specified assigned resources.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources
{
api-version: string ,
projectName: string ,
deploymentName: string ,
body:
{
assignedResourceIds:
[
string ,
]
,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetDeploymentDeleteFromResourcesStatus (new)
Description Gets the status of an existing delete deployment from specific resources job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/delete-from-resources/jobs/{jobId}
{
api-version: string ,
projectName: string ,
deploymentName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetDeploymentStatus (new)
Description Gets the status of an existing deployment job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/jobs/{jobId}
{
api-version: string ,
projectName: string ,
deploymentName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_SwapDeployments (new)
Description Swaps two existing deployments with each other.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/deployments/:swap
{
api-version: string ,
projectName: string ,
body:
{
firstDeploymentName: string ,
secondDeploymentName: string ,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetSwapDeploymentsStatus (new)
Description Gets the status of an existing swap deployment job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/deployments/swap/jobs/{jobId}
{
api-version: string ,
projectName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetExportStatus (new)
Description Gets the status of an export job. Once job completes, returns the project metadata, and assets.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/export/jobs/{jobId}
{
api-version: string ,
projectName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
resultUrl: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_ListExportedModels (new)
Description Lists the exported models belonging to a project.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/exported-models
{
api-version: string ,
projectName: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
exportedModelName: string ,
modelId: string ,
lastTrainedDateTime: string ,
lastExportedModelDateTime: string ,
modelExpirationDate: string ,
modelTrainingConfigVersion: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetExportedModel (new)
Description Gets the details of an exported model.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/exported-models/{exportedModelName}
{
api-version: string ,
projectName: string ,
exportedModelName: string ,
}

⚐ Response (200)

{
exportedModelName: string ,
modelId: string ,
lastTrainedDateTime: string ,
lastExportedModelDateTime: string ,
modelExpirationDate: string ,
modelTrainingConfigVersion: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_CreateOrUpdateExportedModel (new)
Description Creates a new exported model or replaces an existing one.
Reference Link ¶

⚼ Request

PUT:  /authoring/analyze-conversations/projects/{projectName}/exported-models/{exportedModelName}
{
api-version: string ,
projectName: string ,
exportedModelName: string ,
body:
{
trainedModelLabel: string ,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_DeleteExportedModel (new)
Description Deletes an existing exported model.
Reference Link ¶

⚼ Request

DELETE:  /authoring/analyze-conversations/projects/{projectName}/exported-models/{exportedModelName}
{
api-version: string ,
projectName: string ,
exportedModelName: string ,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetExportedModelJobStatus (new)
Description Gets the status for an existing job to create or update an exported model.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/exported-models/{exportedModelName}/jobs/{jobId}
{
api-version: string ,
projectName: string ,
exportedModelName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetImportStatus (new)
Description Gets the status for an import.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/import/jobs/{jobId}
{
api-version: string ,
projectName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_ListTrainedModels (new)
Description Lists the trained models belonging to a project.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/models
{
api-version: string ,
projectName: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
label: string ,
modelId: string ,
lastTrainedDateTime: string ,
lastTrainingDurationInSeconds: integer ,
modelExpirationDate: string ,
modelTrainingConfigVersion: string ,
hasSnapshot: boolean ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetTrainedModel (new)
Description Gets the details of a trained model.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}
{
api-version: string ,
projectName: string ,
trainedModelLabel: string ,
}

⚐ Response (200)

{
label: string ,
modelId: string ,
lastTrainedDateTime: string ,
lastTrainingDurationInSeconds: integer ,
modelExpirationDate: string ,
modelTrainingConfigVersion: string ,
hasSnapshot: boolean ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_DeleteTrainedModel (new)
Description Deletes an existing trained model.
Reference Link ¶

⚼ Request

DELETE:  /authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}
{
api-version: string ,
projectName: string ,
trainedModelLabel: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_EvaluateModel (new)
Description Triggers evaluation operation on a trained model.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:evaluate
{
api-version: string ,
projectName: string ,
trainedModelLabel: string ,
body:
{
kind: enum ,
trainingSplitPercentage: integer ,
testingSplitPercentage: integer ,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_LoadSnapshot (new)
Description Restores the snapshot of this trained model to be the current working directory of the project.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:load-snapshot
{
api-version: string ,
projectName: string ,
trainedModelLabel: string ,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetEvaluationStatus (new)
Description Gets the status for an evaluation job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluate/jobs/{jobId}
{
api-version: string ,
projectName: string ,
trainedModelLabel: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
result:
{
evaluationOptions:
{
kind: enum ,
trainingSplitPercentage: integer ,
testingSplitPercentage: integer ,
}
,
modelLabel: string ,
trainingConfigVersion: string ,
percentComplete: integer ,
}
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetModelEvaluationResults (new)
Description Gets the detailed results of the evaluation for a trained model. This includes the raw inference results for the data included in the evaluation process.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/result
{
api-version: string ,
projectName: string ,
trainedModelLabel: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
stringIndexType: string ,
}

⚐ Response (200)

{
value:
[
{
text: string ,
language: string ,
entitiesResult:
{
expectedEntities:
[
{
category: string ,
offset: integer ,
length: integer ,
}
,
]
,
predictedEntities:
[
{
category: string ,
offset: integer ,
length: integer ,
}
,
]
,
}
,
intentsResult:
{
expectedIntent: string ,
predictedIntent: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetModelEvaluationSummary (new)
Description Gets the evaluation summary of a trained model. The summary includes high level performance measurements of the model e.g., F1, Precision, Recall, etc.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/summary-result
{
api-version: string ,
projectName: string ,
trainedModelLabel: string ,
}

⚐ Response (200)

{
entitiesEvaluation:
{
confusionMatrix: object ,
entities: object ,
microF1: number ,
microPrecision: number ,
microRecall: number ,
macroF1: number ,
macroPrecision: number ,
macroRecall: number ,
}
,
intentsEvaluation:
{
confusionMatrix: object ,
intents: object ,
microF1: number ,
microPrecision: number ,
microRecall: number ,
macroF1: number ,
macroPrecision: number ,
macroRecall: number ,
}
,
evaluationOptions:
{
kind: enum ,
trainingSplitPercentage: integer ,
testingSplitPercentage: integer ,
}
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetLoadSnapshotStatus (new)
Description Gets the status for loading a snapshot.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/load-snapshot/jobs/{jobId}
{
api-version: string ,
projectName: string ,
trainedModelLabel: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_ListDeploymentResources (new)
Description Lists the deployments resources assigned to the project.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/resources
{
api-version: string ,
projectName: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
azureResourceId: string ,
region: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_AssignDeploymentResources (new)
Description Assign new Azure resources to a project to allow deploying new deployments to them. This API is available only via AAD authentication and not supported via subscription key authentication. For more details about AAD authentication, check here: https://learn.microsoft.com/en-us/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-azure-active-directory
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/resources/:assign
{
api-version: string ,
projectName: string ,
body:
{
resourcesMetadata:
[
{
azureResourceId: string ,
customDomain: string ,
region: string ,
}
,
]
,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_UnassignDeploymentResources (new)
Description Unassign resources from a project. This disallows deploying new deployments to these resources, and deletes existing deployments assigned to them.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/resources/:unassign
{
api-version: string ,
projectName: string ,
body:
{
assignedResourceIds:
[
string ,
]
,
}
,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetAssignDeploymentResourcesStatus (new)
Description Gets the status of an existing assign deployment resources job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/resources/assign/jobs/{jobId}
{
api-version: string ,
projectName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetUnassignDeploymentResourcesStatus (new)
Description Gets the status of an existing unassign deployment resources job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}
{
api-version: string ,
projectName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_ListTrainingJobs (new)
Description Lists the non-expired training jobs created for a project.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/train/jobs
{
api-version: string ,
projectName: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
result:
{
modelLabel: string ,
trainingConfigVersion: string ,
trainingMode: enum ,
trainingStatus:
{
percentComplete: integer ,
startDateTime: string ,
endDateTime: string ,
status: enum ,
}
,
evaluationStatus:
{
percentComplete: integer ,
startDateTime: string ,
endDateTime: string ,
status: enum ,
}
,
estimatedEndDateTime: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetTrainingStatus (new)
Description Gets the status for a training job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/{projectName}/train/jobs/{jobId}
{
api-version: string ,
projectName: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
result:
{
modelLabel: string ,
trainingConfigVersion: string ,
trainingMode: enum ,
trainingStatus:
{
percentComplete: integer ,
startDateTime: string ,
endDateTime: string ,
status: enum ,
}
,
evaluationStatus:
{
percentComplete: integer ,
startDateTime: string ,
endDateTime: string ,
status: enum ,
}
,
estimatedEndDateTime: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_CancelTrainingJob (new)
Description Triggers a cancellation for a running training job.
Reference Link ¶

⚼ Request

POST:  /authoring/analyze-conversations/projects/{projectName}/train/jobs/{jobId}/:cancel
{
api-version: string ,
projectName: string ,
jobId: string ,
}

⚐ Response (202)

{
operation-location: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetProjectDeletionStatus (new)
Description Gets the status for a project deletion job.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/global/deletion-jobs/{jobId}
{
api-version: string ,
jobId: string ,
}

⚐ Response (200)

{
jobId: string ,
createdDateTime: string ,
lastUpdatedDateTime: string ,
expirationDateTime: string ,
status: enum ,
warnings:
[
{
code: string ,
message: string ,
}
,
]
,
errors:
[
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_ListAssignedResourceDeployments (new)
Description Lists the deployments to which an Azure resource is assigned. This doesn't return deployments belonging to projects owned by this resource. It only returns deployments belonging to projects owned by other resources.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/global/deployments/resources
{
api-version: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
projectName: string ,
deploymentsMetadata:
[
{
deploymentName: string ,
lastDeployedDateTime: string ,
deploymentExpirationDate: string ,
}
,
]
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetSupportedLanguages (new)
Description Lists the supported languages for the given project type.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/global/languages
{
api-version: string ,
projectKind: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
languageName: string ,
languageCode: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_GetSupportedPrebuiltEntities (new)
Description Lists the supported prebuilt entities that can be used while creating composed entities.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/global/prebuilt-entities
{
api-version: string ,
language: string ,
multilingual: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
category: string ,
description: string ,
examples: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}
AnalyzeConversationAuthoring_ListTrainingConfigVersions (new)
Description Lists the support training config version for a given project type.
Reference Link ¶

⚼ Request

GET:  /authoring/analyze-conversations/projects/global/training-config-versions
{
api-version: string ,
projectKind: string ,
top: integer ,
skip: integer ,
maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
trainingConfigVersion: string ,
modelExpirationDate: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: enum ,
message: string ,
target: string ,
details:
[
string ,
]
,
innererror:
{
code: enum ,
message: string ,
details: object ,
target: string ,
innererror: string ,
}
,
}
,
}